home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / STREAMS_TIMEOUT.z / STREAMS_TIMEOUT
Encoding:
Text File  |  1998-10-30  |  5.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTRRRREEEEAAAAMMMMSSSS____TTTTIIIIMMMMEEEEOOOOUUUUTTTT((((DDDD3333XXXX))))                                      SSSSTTTTRRRREEEEAAAAMMMMSSSS____TTTTIIIIMMMMEEEEOOOOUUUUTTTT((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT - synchronize timeout with STREAMS mechanism
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_rrrr_mmmm_pppp_...._hhhh_>>>>
  13.  
  14.      _tttt_oooo_iiii_dddd______tttt _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT_((((_ssss_tttt_rrrr_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt_ffff_uuuu_nnnn_cccc______tttt _f_u_n_c_,,,, _vvvv_oooo_iiii_dddd _****_a_r_g_,,,, _iiii_nnnn_tttt _t_i_m_e_))))_;;;;
  15.      _tttt_oooo_iiii_dddd______tttt _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT_1111_((((_ssss_tttt_rrrr_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt_ffff_uuuu_nnnn_cccc______tttt _f_u_n_c_,,,, _vvvv_oooo_iiii_dddd _****_a_r_g_,,,, _iiii_nnnn_tttt _t_i_m_e_,,,, _vvvv_oooo_iiii_dddd
  16.      _****_a_r_g_1_))))_;;;;
  17.      _tttt_oooo_iiii_dddd______tttt _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT_2222_((((_ssss_tttt_rrrr_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt_ffff_uuuu_nnnn_cccc______tttt _f_u_n_c_,,,, _vvvv_oooo_iiii_dddd _****_a_r_g_,,,, _iiii_nnnn_tttt _t_i_m_e_,,,, _vvvv_oooo_iiii_dddd
  18.      _****_a_r_g_1_,,,, _vvvv_oooo_iiii_dddd _****_a_r_g_2_))))_;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      The _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT macros provide writers of STREAMS device drivers and
  22.      modules with an interface for synchronizing timeouts with the STREAMS
  23.      mechanism on multi-processor IRIX systems. Under IRIX, it is not
  24.      permitted to call STREAMS interface routines (e.g., _aaaa_llll_llll_oooo_cccc_bbbb(), _pppp_uuuu_tttt_qqqq(),
  25.      _qqqq_eeee_nnnn_aaaa_bbbb_llll_eeee()) or otherwise manipulate STREAMS data structures from a
  26.      function called via a timeout without first synchronizing with the
  27.      underlying STREAMS mechanism.
  28.  
  29.      FFFFaaaaiiiilllluuuurrrreeee ttttoooo pppprrrrooooppppeeeerrrrllllyyyy ssssyyyynnnncccchhhhrrrroooonnnniiiizzzzeeee ccccoooouuuulllldddd rrrreeeessssuuuulllltttt iiiinnnn ccccoooorrrrrrrruuuupppptttteeeedddd ddddaaaattttaaaa ssssttttrrrruuuuccccttttuuuurrrreeeessss
  30.      aaaannnndddd kkkkeeeerrrrnnnneeeellll ppppaaaannnniiiiccccssss....
  31.  
  32.      The _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT interfaces arrange for _f_u_n_c to be called in _t_i_m_e/HZ
  33.      seconds, and guarantee that it will be properly synchronized with the
  34.      STREAMS mechanism.
  35.  
  36.      One, two or three arguments may be passed to _f_u_n_c by using
  37.      _S_T_R_E_A_M_S__T_I_M_E_O_U_T, _S_T_R_E_A_M_S__T_I_M_E_O_U_T_1 or _S_T_R_E_A_M_S__T_I_M_E_O_U_T_2 respectively.
  38.  
  39.      The _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT interfaces do not guarantee the spl level that _f_u_n_c
  40.      will run at. It is the responsibility of the driver or module writer to
  41.      explicitly set the desired spl level within _f_u_n_c. However, the driver or
  42.      module writer "must not" under any circumstances set the spl level to
  43.      spl0 within _f_u_n_c.
  44.  
  45.    DDDDiiiiaaaaggggnnnnoooossssttttiiiiccccssss
  46.      The _SSSS_TTTT_RRRR_EEEE_AAAA_MMMM_SSSS______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT interfaces return a positive _t_o_i_d__t on success. This
  47.      _t_o_i_d__t value may be used by a subsequent call to _uuuu_nnnn_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt() to cancel
  48.      the timeout. If an error is detected while setting the timeout, a _t_o_i_d__t
  49.      of 0 will be returned and no timeout will be set.
  50.  
  51.    SSSSeeeeeeee AAAAllllssssoooo
  52.      _ssss_tttt_rrrr_eeee_aaaa_mmmm_ssss______iiii_nnnn_tttt_eeee_rrrr_rrrr_uuuu_pppp_tttt(D3X), _uuuu_nnnn_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3), _I_R_I_X _D_e_v_i_c_e _D_r_i_v_e_r _P_r_o_g_r_a_m_m_i_n_g
  53.      _G_u_i_d_e
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.